home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / dir / mtool / mfind / mfind_d.doc < prev    next >
Encoding:
Text File  |  1994-04-30  |  7.9 KB  |  211 lines
  1.  
  2.  
  3.  
  4.                                MultiFind
  5.                                  V1.0
  6.                                25.4.1994
  7.                            - Public Domain -
  8.  
  9.                           BEDIENUNGSANLEITUNG
  10.  
  11.  
  12. 1. Vorbemerkungen:
  13.  
  14. MultiFind ist echtes Public Domain. Sie dürfen mit dem Programm oder
  15. seinem Source tun und lassen was immer Sie wollen. Wenn Sie es weiter-
  16. geben, wäre es natürlich am besten, der Quellcode und die Anleitung
  17. wären mit dabei. Aber irgendwelche Vorschriften diesbezüglich mache
  18. ich hier bewußt nicht.
  19.  
  20. Sie verwenden MultiFind auf eigene Gefahr. Ich schließe hiermit jegliche
  21. Haftung für Schäden, die MultiFind verursacht ausdrücklich aus. Dies
  22. gilt für Bedienfehler ihrerseits, Programmabstürze und auch wenn es
  23. sich anderweitig danebenbenimmt.
  24.  
  25. MultiFind wurde speziell zur Verwendung mit meinem Directory Utility
  26. MultiTool II geschrieben. Es kann aber auch in andere Programme dieser
  27. Art eingebunden werden oder als eigenständiges Programm von der
  28. Workbench oder der Shell aus gestartet werden.
  29.  
  30. Es wäre nett, wenn Sie mir jeden Fehler der Ihnen begegnet mitteilen
  31. würden. Nur so kann ich ihn beheben!
  32.  
  33. Wenn Sie MFind verbessern, würde ich mich über die Zusendung Ihres
  34. Werks sehr freuen.
  35.  
  36.                                                Boris Jakubaschk
  37.                                                Neue Straße 14/1
  38.                                                70186  Stuttgart
  39.                                                     Deutschland
  40.  
  41.                                                 ++49 711 462989
  42.  
  43.                                               FIDO 2:246/1115.2
  44.                                 EMail Boris@alice.tynet.sub.org
  45.  
  46. Herzlichen Dank an:
  47.   - Matt Dillon für DICE
  48.   - Jan van den Baard für GadToolsBox
  49.  
  50.  
  51. 2. Zweck des Programms:
  52.  
  53. Sicher ist es Ihnen schon öfter passiert, daß Sie eine Datei auf
  54. Ihrer Festplatte oder einer Diskette "verloren" haben. Sie können
  55. sich noch erinnern, daß es ein Brief an Tante Erna war. Aber wie
  56. die Datei hieß ist Ihnen entfallen. Oder Sie wissen, daß die
  57. Datei "ErnaBrief3.TXT" hieß - aber in welchem Verzeichnis hat sie
  58. sich versteckt?
  59.  
  60. Hier setzt MultiFind an: Sie können wahlweise nach Dateinamen (bzw.
  61. Suchmustern) oder Teilen des Dateiinhaltes suchen. MFind durchsucht
  62. die angegebenen Verzeichnisse, auf Wunsch auch deren Unterverzeich-
  63. nisse - zur Not die gesamte Festplatte. Das geht auch bei der Suche
  64. in Dateien in Windeseile.
  65.  
  66. Ein komfortables Eingabefenster macht die Auswahl der zu durchsuchen-
  67. den Verzeichnisse und des Suchwortes zum Kinderspiel. Alle bei der
  68. Suche gefundenen Dateien werden in einer Liste angezeigt. Dort
  69. können sie ausgewählt und weiterverwertet werden: Mit einem Mausklick
  70. übertragen Sie den Dateinamen ins Clipboard, rufen einem Editor auf,
  71. der gleich das gesuchte Wort anspringt oder lassen das zur Datei
  72. gehörende Verzeichnis in MTool anzeigen.
  73.  
  74.  
  75.  
  76. 3. Einstellungen:
  77.  
  78. Nach dem Programmstart sehen Sie ein Eingabefenster. Im oberen Bereich
  79. können Sie das Suchwort festlegen. Darunter sind zwei Listen. Die
  80. linke, größere wird später die gefundenen Dateien anzeigen, die rechte
  81. dient der Aufnahme der zu durchsuchenden Verzeichnisse oder Dateien.
  82.  
  83. Betrachten wir zunächst den oberen Bereich. Hier können Sie den Such-
  84. string angeben und festlegen, ob dieser einen Dateinamen oder einen
  85. Teil des Dateiinhalts darstellen soll. Darunter befinden sich vier
  86. Felder, die die Suche genauer beschreiben:
  87.  
  88. - Nur Dateinamen: Ist nur bei der Suche nach Dateinamen relevant.
  89.       Wenn dieser Punkt angewählt ist, wird das Namensmuster nur mit
  90.       dem Dateinamen und nicht mit dem Pfad verglichen. Wenn Sie z.B.
  91.       "#?info#?" als Suchstring angegeben haben, wird eine Datei
  92.       "Work:Texte/Messeinfo/Commodore.TXT" nur gefunden, wenn dieser
  93.       Punkt nicht angewählt ist, da das "info" im Pfad und nicht im
  94.       Dateinamen auftritt.
  95. - Groß-/Klein: Ist dieser Punkt angewählt, wird bei der Suche zwischen
  96.       Klein- und Großbuchstaben unterschieden. Im Normalfall ist er
  97.       nicht angewählt, da das Betriebssystem bei Dateinamen auch keine
  98.       Unterscheidung macht.
  99. - HEX-Modus: Ist nur bei der Suche nach Dateiinhalten relevant. Wenn
  100.       Sie diesen Punkt anwählen, wird der Suchstring als HEX-Zahl
  101.       betrachtet. Jeweils zwei Hexziffern ergeben ein Byte der zu
  102.       suchenden Bytefolge.
  103. - Unterverz.: Im Normalfall werden alle Unterverzeichnisse eines
  104.       gewählten Verzeichnisses mitdurchsucht. Sollten Sie nur das
  105.       eigentliche Verzeichnis durchsuchen wollen, müssen Sie diesen
  106.       Punkt abwählen.
  107.  
  108. Nun müssen Sie noch die Verzeichnisse auswählen, die Sie durchsuchen
  109. lassen möchten. Dazu wählen Sie oberhalb der rechten Liste das Feld
  110. "Neu" an. Es erscheint ein Filerequester, in dem Sie das gewünschte
  111. Verzeichnis auswählen können. Der Name erscheint dann in der Liste.
  112. Dies können Sie beliebig oft wiederholen. Sollten Sie ein Verzeichnis
  113. versehentlich in die Liste eingetragen haben, können Sie es anwählen
  114. und mit dem Feld "Entf." löschen.
  115.  
  116. Nachdem der Suchstring eingetragen wurde und mindestens ein Verzeichnis
  117. ausgewählt wurde, kann die Suche beginnen. Dazu wählen Sie "Start".
  118. Danach können Sie die Suche jederzeit mit "Stopp" wieder abbrechen.
  119.  
  120. Sollten Sie meherere Suchdurchläufe starten, werden die gefundenen
  121. Dateien immer an die linke Liste angehängt. Wenn Sie die Liste leeren
  122. wollen, müssen Sie "Löschen" anwählen.
  123.  
  124.  
  125.  
  126. 4. Was nun?
  127.  
  128. Die in der Liste angezeigten Dateinamen können von MFind auf drei
  129. verschiedene Arten verwertet werden. Dazu dienen die drei Gadgets
  130. links von "Abbruch" am unteren Fensterrand:
  131.  
  132. - MTool: Das Verzeichnis der Datei wird in die aktive Dateiliste
  133.      von MTool übernommen und die Datei markiert. Dies wird erst
  134.      ab MTool V2.1 gehen, da bisher kein ARexx-Port eingebaut ist.
  135.  
  136. - Clipboard: Der vollständige Dateiname wird ins Clipboard geschrie-
  137.      ben. So kann er z.B. mit Amiga-v im CLI eingefügt werden.
  138.  
  139. - Editor: Der Editor wird gestartet, die Datei eingeladen und das
  140.      Suchwort innerhalb der Datei angesprungen.
  141.  
  142.  
  143. 5. Konfigurierung
  144.  
  145. MultiFind kann an Ihre Softwareausstattung angepaßt werden. Beim
  146. Aufruf über die Workbench können Tooltypes, beim Aufruf per CLI
  147. Parameter angegeben werden. Folgende Parameter sind erlaubt:
  148.  
  149. ED_Cmd=<Dateiname>
  150.     - Name des Editors. An der Stelle, wo der Dateiname eingesetzt
  151.       werden soll, muß ein "%s" stehen. Default ist "EDC %s".
  152.  
  153. ED_Port=<ARexx-Port>
  154.     - Name des ARexx-Ports des Editors. Default ist "rexx_ced".
  155.  
  156. ED_RxCmd=<ARexx-Befehl>
  157.     - ARexx-Befehl, der ausgeführt werden soll. Der Byteoffset,
  158.       zu dem gesprungen werden soll, wird für "%d" eingesetzt.
  159.       Default ist "Jump to byte %d".
  160.  
  161. MT_Port=<ARexx-Port>
  162.     - Name des ARexx-Ports von MTool (oder einem anderen Dateima-
  163.       nager wenn's unbedingt sein muß ;-)). Default ist
  164.       "rexx_mtool"
  165.  
  166. MT_RxCmd=<ARexx-Befehl>
  167.     - ARexx-Befehl, der den Dateimanager dazu bewegt, das Ver-
  168.       zeichnis anzuzeigen. Default ist "Get dir actual %s".
  169.  
  170. PATHSFILE=<Dateiname>
  171.     - Textdatei, in der die Pfade stehen, die nach dem Programm-
  172.       start in der Liste der zu durchsuchenden Pfade erscheinen.
  173.       So kann MFind einfach in MTool eingebunden werden. Als
  174.       Parameter in den Programmvoreinstellungen von MTool ist
  175.       "PATHSFILE=%s" (inclusive Anführungszeichen) einzusetzen,
  176.       darunter dann "Quellpfade in Namensdatei". MTool wird dann
  177.       beim Aufruf von MFind alle in der aktuellen Dateiliste
  178.       markierten Pfade übergeben.
  179.  
  180.  
  181. 6. History
  182.  
  183. V1.0  - 25.04.1994 (zusammen mit MTool 2.0c veröffentlicht)
  184.  
  185. NEU:
  186.  
  187. - Horizontale Schieberegler
  188.  
  189. Bekannte Fehler:
  190.  
  191. - Dirutility-Steuerung zwar theoretisch vorhanden aber völlig
  192.   ungetestet, da MTool noch keinen ARexx-Port hat.
  193.  
  194. - Weiterhin Probleme mit GoldEd. We're working on it ;-)
  195.  
  196.  
  197. V1.0ß - 12.03.1994 (nicht veröffentlicht)
  198.  
  199. Erste brauchbare Version. 
  200.  
  201. Geplante Änderungen:
  202.  
  203. - Horizontale Schieberegler an den Listviews.
  204.  
  205. Bekannte Fehler:
  206.  
  207. - Die Editorsteuerung wurde mit dem CED und mit GoldEd getestet.
  208.   CED geht, bei GoldEd hängt MFind nach dem Aufruf.
  209.  
  210. - MToolsteuerung noch nicht eingebaut
  211.